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Load  the  program  (using  LOAN  ""  )  :.r.d  RUN.  At  this  point  you 
will  be  presented  with  an  identifyii 
of  option-.;  available  on  the  primary 

make  the.  program  sol:  aocun.enti *  however  m  the  primary  loop 
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phoning.  When  you  hear  the  other  modem,  ouch 
oint  you  will  enter  the  primary  loop  where  you 
have  the  f oil owing  options. 
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Modem  Control . Shift/1. 

S  a ve  1  oggl  e .  . . Shift /T 

Up/Down  Loading. . Shift/3 

Quit  (all  functions ).. .Shif t/NewLine 

View  Data  Rem . Shift/4 

Save  Page . Shift/9 

Initialise  Files . Shift/2 

Usually  hitting  the  ENTER  key  a  couple  of  times  is  enough  to 
tart  the  remote  system. 
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function  descriptions 

Quit  (S/NL)  In  every  part  of  the  program  if  you  wish  to  quit 
what  you  arc.  doing,  Shift/Mewline  will  return  you  to  the  next 

higher  function  (or  to  Basic).  When  you  wish  to  return  to  Basic 

4?  ,  ,  .  -i  o  /MT  uu i  i  ”*  r '  you  with  MSAV  ^  ok*  ILLS  ( KL/ N  )?M 

1  rom  "the  primary  to  jp,  o/iUj  w Ux  y*  *»  j 

If  you  change  your  mind,  S/NL  wi  ■  _  put  you  cac..  ira.o 

loop.  If  you  choose  "K" ,  the  basic  area  will  be  left  unchanged. 

If  you  choose  "Y"  ,  the  data  remark  will  be  shortened  to  the¬ 
se  tual  length  of  the  data,  and  you  will  be  prompted  to  star:  your 
tape  recorder.  Note:  If  you  have  not  initialized  a  data  remark 
(See  I NIT  Files),  the  program  will  detect  this  art  merely  ,uit. 

Simplex  Toggle  (S/D)  Shift/D  toggles  the  display  of  what  you 
type  off  and  on.  Most  Bulletin  Boards  will  echo  back  to  you 
whatever  you  enter.  This  is  the  function  »o  u~e 
duplicate  letters  on  the  screen. 
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(See  the  Memory  Maps)  Before  saving  any  data,  (by  S/T,S/9,  or  Xmodem; 

t 

you  must  initialize  the  files. 

Save  Toggle  (S/T)  In  the  primary  loop  S/T  will  cause  "SAvib  iOGG.uE 
ON"  to  be  displayed  on  the  bottom  line.  This  command  causes  all 
input  and  output  to  be  saved  in  the  data  remark.  There  is  a  test 
built  in  to  tell  you  when  the  Remark  is  full.  Note:  You  must 
Initialize  Files  before  using  S/T. 
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Save  Page  (S/9)  In  the  primary  loop  you  can  save  an  entire  page 
with  Shift/9.  When  you  do  this  you  will  see  displayed  across  the 
bottom  of  the  screen  (for  a s  long  as  you  hold  the  keys  down),  the 
page  number,  and  the  number  of  bytes  remaining  in  the  data  Rem 


(in  hexadecimal).  Note:  you  must  initialise  t he  file 


s.  oef ore 


using  this  function 


vr 1 Data  Remark:  \ 

I /a )  In  the  nr: mar y  1 

oop  you 

can  view 

whatever 

information  is  in 

the  data  Ren  by  using 

the  S/4 

c  omraand . 

You  will 

be  prompted  with  " 

(A)scii  or  (S)inclair 

file?"  . 

A  mistake 

^  c-  ti  t  ni  s 

point  wi — l  get  you  a  screen  full  of  garbage.  After  each  screen  is 


displayed,  you  have  the  option 
the  next  screen,  or  quitting. 


of  or 


ng  the  screen,  going  to 


.V  ode  n  C  c  r.  t  r  o  1  ( S  A' )  There  are  different  versions  of  Modem  Control 
depending  upon  which  modem  you  use. 

Westridge  S/Y  will  cause  "MODEM  CONTROL:  (H)ANGUP  (C)ARRIER" 

to  oe  displayed.  You  may  use  this  function  to  turn  off  the 
carrier,  so  you  can  dial  once  again.  Note  that  returning  to 
basic  from  the  primary  loop  also  shuts  off  the  carrier.  When 
you  hear  the  other  modem  start,  S/Y  followed  by  "C"  allows  you 
to  communicate. 

B.yteSack  S/Y  will  cause  "MODEM  CONTROL:  (A ) NEWER  ( ORIGINATE" 

to  be  displayed.  The  primary  use  of  this  option  would  be  in 

* 

arranging  direct  Sinclair  to  Sinc-lair  connections,  as  opposed 
to  Sinclair  to  bulletin  board. 

In  both  versions  the  modem  is  initialized  to  Originate  mode. 
Because  the  Xmodem  protocol  directly  specifies  8  data  bits,  1  stop 
bit  and  no  parity,  I  have  not  provided  for  other  parameters  in 

software.  If  you  wish  to  use  Mini  Xmod  on  a  board  which  uses  other 
protocols,  see  the  section  Changing  Parameters. 
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Mode  A'crd 


4?  Hex. 
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?3 
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ByteBack  (18226) 

Bata  Bits  S ton  Bits 


8 

7 
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1 
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Parity 

none 

even 

odd 

even 


Mode  W or  I 
4E  Hex 

7A 

5A 

TP  n 


78  Dec 
122 
90 
242 


For  example ,  to  set  the  Westridge  version  of  Mini  Xmod  to  7  data 
bits,  1  stop  bit,  and  even  parity;  Load  Mini  Xmod  and  then 
Poke  18222,123  and  then  RUN  to  transfer  the  program  to  its 
proper  area.  Note  that  Xmodem  will  not  work  properly  with  any 
setting  other  than  8  Data  bits,  1  Stop  bit  &  no  parity. 
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— C~’  '•  rhere  arc  several  different  ways  to  send 

C  ( s  c  a  i  n  e  ;  is  Control-M.  There  are  several  commonly 

U“ 6<i  '"'5n:'ro1  Cr‘  T'-cters  which  can  be  sent  using  just  the  SHIFT  key. 
These  -re  Cntrl-,:,  Cntrl-J,  Cntrl-L,  1  Cntrl-I  (  using  the  Arrow 
Keys)  and  Cntrl-S  using  Gnift/S. 

Control  characters  from  A-Z  may  be  sent  using  S/l  as  well,  then 

/ou  use  this,  you  will  see  Control  Character  displayed  across  the 
o  w  u o .Ti  oi  t» h c  rcr o n . 

Cntrl  ♦  C  h- r  .  S umr.  ~ r y 

newline  (enter)  -  Crtri-1 

ohif t/8  —  Cntrl— I 

Shiit/7  -  Cntrl-K  //  ,> 

Sfcift/6  -  Cntrl-J 
Shift/5  -  Cntrl -H 

chiit/C  -  Cntrl-S  _  J 

shift/1  -  Cntrl- (A*  to  Z) 
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ulair  to  ASCII  Arcning  (&  b-  ck) 


One  of  the  more  interesting  ouirks  of  the  Sinclair  computer  is 
that  it  doesn’t  use  ASCII  like  the  rest  of  the  world.  This  means 
tlr:t  to  communicate  with  the  outside  world,  the  terminal  program  has 
to  oi -...olds  Sinclair  codes  into  ASCII  codes  &  viceversa.  The  numbers 
,'r!G  -LG't:'*:ers  ',re  “tr  -  ig htf  orward ,  but  there  are  some  symbols  in  each 
which  the  other  doesn't  have.  These  two  tables  show  how  I  have  mapped 
these  oddball  symbols. 

t 

Sinclair  to  -SCII  (sending) 

S/Q  f, 

S/.V  j 

S/E 
S/R 
S/A 
S/F 

SA 

S/H 


T 

C 
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// 
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APDII  to  Sinclair  (R.-eeivin. 


Sinclair  Code  (Decimal) 


( un'.  erl  ire  )  - 


149 


(  |  ( inverse  ) 


144 


I 


ttttGP 


137 


Crtri('-i  >  n 


to  the  inverse  letter. 


•v  +;  i 


Kmod em? 


Sometimes  celled  the  Christensen  protocol,  XMODEM  is  a  method  of 
tr^rsferrinr*  fries  over  unreliable  telephone  lines.  A  reliability 
of  9'>  +  is  cl-imrd.  Basically  the  technioue  transfers  80(hex)  bytes, 
tells  the  other  commuter;  this  is  the  nt;"  block  of  data  &  this  is 
the  checksum;  do  you  spree?  If  the  sendier  and  the  receiver  comoute 
different  checksums,  a  block  of  dat°  is  retransmitted  a  maximum  of 
10  times  (after  which  the  pro, /pram  aborts).  There  is  a  built  in 
timeout  each  time  a  block  repeats  to  ensure  the  synchronization  of 
the  two  systems. 

//hen  the  sender  and  receiver  agree  that  the  last  block  was 
correctly  received,  the  next  block  is  sent.  More  detailed  info  can 
be  found  on  many  CP/K  systems  in  a  file  called  "KODEKPRT .0Q1"  ► 
bote  that  M.IM  XI..  OD  will  upload  a  Sinclair  program  up  to 

the  display  file  (ie.  not  the  variables  area).  Also,  besides  the 
checksum  techrioue  of  catching  errors,  Xmodem  can  use  Cyclic 
Redundancy  Check  (CRC)..  This  is  not  implemented  in  Mini  Xmod.  For 
this  reason  when  sending  a  file  to  Xmodem  you  need  to  specify 
"  RC  ",  for  receive  with  checksum. 
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UP/LO.'/N  LOADING  (S/3)  -  This  command  will  present  you  with 
the  message  "  (U)P  (D)OWM  (T)RANSFER  QUIT  Once 

you  have  told  the  other  system  whet  you  are  doing,  you  need 
only  touch  U  or  D  to  initiate  a  transfer  of  files.  Note  that 
if  you  are  downloading  (ie.  sending  a  file  from  the  remote 
system  to  your  computer),  you  must  have  initialized  the  files 
( °v  using  $/<•-)•  There  is  a  memory  test  built  into  the  Download 


option , 
file  whi 


so  that  if  you  tell  the  remote  system  to  send  you  a 
ch  is  longer  than  your  Data  REMark,  Mini  Xmod  will 


stop  downloading  and  tell  you  so. 


the 

the 


vVhen  you  have  downloaded  a  Sinclair  ( ZX81/TS1000)  program, 
(T)rarsfer  function  can  be  used  to  put  the  program  into 
Sinclair  basic  area  so  that  it  can  be  run. 


There  is  a.  timeout  of  10  seconds  built  into  Xmodem,  so  every 
once  in  a.  while  (when  first  dov/nloading  &  on  repeating  blocks), 
the  program  will  appear  to  be  doing  nothing.  However  if  nothing 
happens  for  longer  periods  of  time,  there  is  an  escape-function 
built  into  Xmodem.  It  will  not  always  work  because  sometimes 
the  program  is  busy  testing  ports  and  suchlike,  however  if  it 
appears  that  something  has  gone  fatally  wrong  with  a  file 
transfer  S/RL  will  usually  get  you  out  to  the  primary  loop, 
//hen  you  invoke  this  escape,  all  data  is  lost. 


USING  XM.ODEM 

//hen  you  are  signed  onto  a  bulletin  board  v/hich  uses  CP/P.', 
you  must  go  to  the  files  section  (Usually  by  entering  "F"  at 
the  command  prompt).  The  system  will  then  do  some  housekeeping, 
and  present  you  with  the  CP/M  prompt  (Al>).  To  invoke  Xmodem 
you  need  only  to  type  the  word  "XMODEM" .  This  tells  CP/M  that 
the  Xmodem  file  needs  to  be  loaded.  Then  you  have  to  tell 
Xmodem  what  you  want  it  to  do;  your  options  are  "  S"  for  Send 
(from  the  remote  system)  or  "  RC"  for  Receive  (with  checksum 
protocol)  from  your  system. 

The  only  other  information  Xmodem  needs  are  the  drive  where 
the  file  is  located  and  the  filename  and  filetype,  (See  Using 
CPAO  such  as  "  A2 :  MODEMPRT .  001"  * 

ft 
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USING  XT  ODE?.1  (cont'd) 

Once  you  h°ve  tyned  in  this  inform tion,  the  remote  system 
will  do  some  housekeeping  (  tell  you  which  version  of  Xmodem 
it  is,  tell  you  how  long  it  will  take  to  transfer  a  given  file, 
or  on  which  drive  it  will  be  received),  then  you  invoke  S/j. 
in  Mini  Xmod  end  touch  U  or  D.  The  transfer  is  automatic  from 
there  on.  The  program  will  tell  you  when  the  transfer  is  complete 
or  aborted. 

'Chore  is  the  odd  bulletin  board  around  using  Xmodem  which 
is  not  CP  A*  based.  Or  these  systems  usually  the  transfer  is 
menu  driven;  the  remote  system  will  tell  you  when  to  invoke  the 
transfer  on  your  system. 


TYPICAL  EXCHANGES 


Once  you  are  into  the  CPA  files  section  downloading  a  file 


might  nroceed  thus: 


Al>  XI-ODEM  S  XMODEM. HLP 


CP A  prompt 


ell  it  to  sen< 


Invoke  Xmodem 


-  ■■■■  - 

he  Filename  &  Filet yp^ 


If  the  file  was  not  on  Al:,  the  system  would  respond; 
•♦•REQUESTED  FILE  EOT  FOUND*** 

You  would  then  have  to  specify  which  c^rive  the  file  was  on  thus 

_ A  1>  XIv  ODEM  S  B b :  XMODEM  .  HLP 

CFA’i  prompt^A^  £end^from  Bb  :*  X— _ _ _ _ 

frvoke  Xmod  err?  The  Filename  &  Filetyp^ 

At  this  point  the  system  would  typically  respond: 

Xmodem  V  7.3 

Bend  time  3  minutes  44  seconds 
File  open  Ready  to  Send 

At  this  noint,  you  go  to  S/3  in  Mini  Xmod  and  touch  "D"  to 
transfer  the  file. 
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— 9. a XC -L' ■  j i'.b  (cort'ci 

io  wlo-:.x  a  -.lie  you  first  load  Mini  Xmod  end  — 

t0/tf^  :-n  return  to  basic  ard^  "he 

.llT:  y  Vi!?  r;  to  .,•-]  OP"  I1  h  i  c-  ■  V  ,  ‘  ' 

....  j.o...,  tins  c-.-.n  oe  nr.y  Sinclair  rrorr-  r 
f'Ht0  ti"'5  Mri  XmcW  d°<  --  not  .r of  er  the  Vnrtabiec  XeX'  .>■  - 
lif  r'  )V|!d  4"  *h«  kosic  '-ret  free  d;;7D  to  the  Diseiay 

.  51'ely'  one  ■ou-lt‘  i.-vote  the  Write  utility  to  c-e=te 

'•U  :°r  ::  ■•'-'’■’-aint.  n  or. 7  rote,  rher-  the  ir.'orr- i' or  ' 

;i,  ra“a  lr  th‘  *^ric  tree,  start  »,i„i  Xn-.od.iSee  ..  . 

for  the  storting  ■  ddresaes  if  you  h-ve  forgotten)  fY\a 1^  {*.  Jo 

/'C  '*  1‘‘  n0lr,t  you  r,eed  to  si&n  onto  the  Bulletin  Board  ar 

',Ct  lr,t0  thc  cp/r,:  files  section.  Uploading  •?.  Sinclai 
v.'oulo  nroceed  thus: 


1  T>  •*-» 


(Sfe 


A 1>  XI..ODKK  RC  CMOS  UTIL.. s 


Invoke  Xmodem 


Pro rrr; m  ft am e  i  ? -  ~ 


i^em/pe 


*4-  4-  a,  • 

o  o 


,11r  eomt  the  system  would  tvric^ly  re-or-r- 

Xmodem  V  g.O 
Checksum  Enabled 
File  will  be  received  on  BO: 

Cntra-o  to  pause,  Cntrl-X  to  cancel 
i  lie  onen  Reedy  to  receive 

uoi.i  o  \  o’i  o  to  S/3,  in  I-  mi  Xmod  end  touch  "U"  +- 


.  -  u"  to 

initiate  the  :  ile  transfer  on  your  end.  The  program  will  tel 

"/0U  '"’ncn  tr,<;  -rrjnnl  er  is  done,  or  of  any  problems. 


C*S. 


Note:  f".ny  versions  of  Xmodem  have  Kelp  files  built  in. 

Al>  XMODEM  ( NEWLINE ) 

Simply  entering  Xmodem  without  any  further  data  will  induce 
the  program  to  type  out  its  help  file. 


'X  y,  ■-  ..  '  -  .  ;  .  :  -J  -•  f  v, .  .  ’  v 

mbw . Mi  it  smBhi  -....si — mtim 


USING  CPAi 

CPA  is  one  of  the  more  popular  operating  systems  around.  Part 
of  this  success  is  due  to  the  C13BS  programs  which  allow  the  remote 
operation  oi  the  Gi/L  system  with  oil  the  options  that  ertails.  A 
complete  description  of  CPA  is  beyond  the  scope  of  this  document 
(see  Suggested  Heading  list);  however  there  are  some  very  basic 
things  you  need  to  know. 

v/her  CPA  expects  a  command  from  you,  it  will  prompt  you  with  Al> 
This  also  tells  you  that  you  are  in  Drive  A,  User  Area  1.  You  may 
change  to  another  Drive  ana  User  Area  by  typing  in  "  User  B5  ". 

I.ote  that  spaces  are  significant  in  using  these  command  words.  CPA 
uses  spaces  to  know  where  the  ends  of  commands  are.  If  you  tell 
CPA  to  do  something  th  t  doesn't  make  sense  to  it,  the  system  will 
echo  your  command  with  a  question  mark. 

There  are  several  built  in  commands  which  you  can  always  execute 
in  CPA,  the  others  have  to  be  loaded  in  from  the  disk  drive  (if 
they  are  implemented).  Among  the  built  in  commands  are  "DIR  " ,  which 
stands  for  DIRectory£  "TYPE  ",  which  will  type  out  a  file  for  you. 
You  can  also  ask  to  see  a  specific  Drive  &  User  Area  by  entering 
"DIR  K4:  ",  for  example.  To  have  the  entire  files  axea  displayed, 
enter  “DIR  A:*..*  $AD"  .  To  exit  the  CPA*  system  one  usually  uses  "BYE 

Files  are  stored  in  CPA-  with  a  Name  and  a  File  type.  Typical 
examples  are;  XKODEK.HLP  (Help) 

READLISA.BAS  (Basic) 

KEXREF.DOC  (Document) 

BOOT ASK. SIN  (Sinclair) 

The  FileName  may  be  up  to  8  characters  long,  and  the  FileType  3» 
There  are  a  group  of  non-alphabetical  characters  which  may  not  be 
used  in  FileNames.  The  Name  and  Type  must  be  seperated  by  a  period. 
There  is  a  set  of  standardized  Types  in  use  which  you  can  find  in 
the  reading  list. 


SUGGESTED  READING  ON  CP A 
Osborne  CPA  User  Guide  -  T. Hogan 
The  CPA  Handbook  -  Rodney  Zaks 
bartering  C?A!  -  A. Killer 

CPA1  Primer  -  I.;urtha  &  Waite  ,* 

CPA-  Revealed  -  J.Dennon  f 

Using  CPA  -  Fernandez  &  Ashley 
The  Programmers  CPA  Handbook-  A.  Johnston  Laird 
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MEMORY  I<  APS 


16K  Version 


OOOO 


Saoi.'. 


?QQG<  ,,V.  e.  , 

>  iOi«.  Shadow 

4000  C  r. 

^System  Variables 

/L'\D-!t:=  RE”/. ark 
6P43  / 

61V  9  OFile  ,, 

7262  Vsrs 
72F0  Rantop 
7300 


7E4G 


Mini  Xmod 


7FFF  End  of  menor 


Starting  Addresses 


■Vestridge-  314 92 
ByteBack  -  31515 


:-0  24K  Version 

0000 v  DAV 
\  ROM 

2000.  WjuSED  ROM  Shadow 

33°°n> Kini  xmod 

3F4°v  Unused  ' 

4000/ 

S System  Variables 

407Data  R£Kark 

7a  a  A  S 


407DB  n  .  _ 

SData  R 

7048/ 

7049  DFile 
7F62  Vars 
7FFF  R amt op 
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Note  that  the  program  uses  some  memory  areas  in  the  system  variables 
(Pr.Buff.  &  MemBot)  for  ^the  temporary  storage  of  pointers  &  flags.  .  •  * 
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SAVE  TOGGLE  (SHIFT  7 )  will  save  all  screen  display  to  the 
memory  or  until  SAVE  TOGGLE  (SHIFT  T)  is  turned  off .  SAVE 
he  used  continuosly  or  intermittently  to  collect  data. 


capacity  of 
10&GLE  can 


SAVE  PAGE  (SHIFT  9)  is  used  to  save  one  full  screen  display  at  a 


2  me . 


VIEWING  DATA 


1»  $2  on  off  of  BBS  then  press  SHIFT  /  then  H  to  shut  off  modem 
carrier. 

2.  Press  SHIFT  4  then  S  when  prompted. 


3.  Follow  instructions  at  bottom  of  screen  to  print  or  continue 
reading  data. 
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1.  Press  SHIFT /ENTER  then  V  when  prompted,  %'"'■**  ** 

[■  ■  ? .  *  k \ 

2.  Follow  screen  directions.  \  * 
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MINI  XMOD  1.5  will  allow  Timex  programs  to  be  u  p/down  loaded  to ■  !’<£'<’  ? 
remote  BBS  and  the  programs  will  RUN.  Programs  with  'data  -sstp-red$k  in  V 
s-trinq  varibl  es  Vi i  1  have  data  removed.  Non- Timex  program,^  'and .  frl  e*  V 
can  be  downloaded .  stored „  and  trans.fered  to  o  the^s  BBS  but  'th^iv  cannot 
be  transferred  to  the  Sinclair  Basic  area  and  RUNJ-  The'v  can  be  LL  1ST  n. 

to  allow,  for  manual  conversion  to  Sane!  air.  Bas.%c,  '  4  ’\'i  i  ‘  ' 

1.1  P  LOADING 
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*  1;  Load  MINI  XMOD  1.5  and  RUN. 
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2.  Press  any  key . 
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Press  SHIP  T / ENTER 


R  •  Press  N  when  prompted 

5.  Press  NEW  to  move  MINI  XMOD  1.5  above  PPM  TOP , 

-•  -  Load  Timex  software. 

7.  Enter  as  a  DIRECT  COMMAND,  RAND  USR  (the  address  c, 

as  determined  by  -/our  system  configuration  as  detail  eo 
m  e  in  doc  u  v>  notation  ) 


of  MINI  XMOD  i 
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i  * 
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Refer  to  &  of  main  documentation  for  XMODEM  procedures 

mdivual  BBS  XMODEM  HELP  FILES  for  system  specific  instruction’s. 

DOWNLOADING 

1.  sol  low  procedures  m  Basic  Function  Summary . 

d.  Refer  to  pace  7  of  main  documentation  and  pay  particular  attentior 
to  pace  IQ,  usino  CP/M  to  ultilize  directory  functions  of  BBS. 


Press  s.‘HIFT  3  then  D  to  download  proqram  or  file. 


W.  When  download  is  complete  press  T  only  if  proqram  is  Timex.  Thi<- 
%  transTer  Proqram  to  the  '-'Eclair  Basic  Area  and  allow  it  'to  RUN I 


General  1  </  accepted  BBS  courtesy  requires  that 
of  r  at  the  end  of  a  session ,  Failure  to  do  so 
systems,  it  can  result  in  loss  of  access . 
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This  software  fully  supports  both  the  MENOTECH 
with  full  sized  Centronics  printer  and  the  TIMEX 


CENTRONICS  INTERFACE 
2040  printer. 


NOTE 

.If  you  notice  an  inverse  "J”  at  the  beginning  of  each  line,  it 
indicates  that  the  BBS  is  sending  “Line  Feeds”.  This  can  be  toggled 
off  usually  through  instructions  included  in  the  sign  on  menu. 
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S.  De-active  SAVE  TQGGlE  (3-1-7  7> . 
7. Press  SH I P~  ENTER  twice. 

S.  wren  tne  SAVE  -ILES'"' 
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^•en.  Dress  the  BREAK  key. 
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